home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
BUSINESS
/
SP53.ARJ
/
SP.DOC
< prev
next >
Wrap
Text File
|
1991-01-28
|
17KB
|
399 lines
1. INTRODUCTION
SP is a general purpose plotting package designed specially for
the scientific and engineering professionals. The program is
designed to run on an IBM-pc or compatibles. The SP has a
capability to plot files containing upto 225,000 data pairs. It
can plot on linear, log, Normal probability, Log normal
probability or Weibull scales. Data can be curve fitted to
polynomials or smoothened with bicubic splines. Several functions
are available for transforming the data. The software does not
include data editing capability . It works with data files in
ascii format. Hard copy output can be produced on HP7470A
plotter. The graphics adapters supported are CGA/EGA and Hercules
monochrome.
2. LICENSE AND REGISTRATION
You may use SP without charge on a trial basis to determine
its suitability for you. If you continue to use SP after your
evaluation, a $25 registration is requested. As a registered
user, you will receive a printed manual and information on future
updates. Questions and comments regarding this software should be
mailed to the following address. You may freely distribute SP
if you keep the entire package together and unchanged, including
this license explanation, and do not charge more than $5 for it.
The SP package is distributed as an archived file, (SP53.ZIP),
which contains the following files :
SP.EXE SP executable
SP.DOC SP documentation
ROCKWL.DAT Sample data file
FATIG.DAT Sample data file
HIST.DAT Sample data file
SENDHPGL.EXE Program for downloading HPGL file
to a plotter
To register your copy of SP, send your name, address,and $25
check to:
D. Dedhia
P. O. Box 3298
Santa Clara CA 95055
The registered users can acquire the complete source code for SP
(written in QuickBASIC) for $195.
SP is provided as is. There are no warranties expressed or
implied.
3. SYSTEM REQUIREMENTS
The following minimum hardware is requred to run the SP software:
IBM-pc or compatible computer
One floppy disk drive
385 K RAM
CGA, EGA or Hercules monochrome graphics adaptor
HPGL comatible pen plotter (optional)
Epson or compatible dot matrix printer(optional)
4. INSTALLTION
The SP program is distributed as an archived .ZIP file and
requires PKUNZIP (available from CIME bulletin board) to extract
the files contained in the archive. No other installtion is
required. Extract the files to a working disk or to a hard disk.
For program execution, only SP.EXE is required. If you have a
HPGL plotter connected to either COM1 or COM2 port, the switch
settings on the plotter should correspond to 9600 baud, 7 data
bits, 1 stop bit, and parity space. On the HP7470A plotter, it
corresponds to the following switch settings :
Switch number S2 S1 Y US B4 B3 B2 B1
Set 0 0 0 1 1 0 1 0
5. STRUCTURE OF DATA FILES
The SP can read two types of data files :
Type 1 : This type of file can have upto 16 columns and upto
15,000 rows data. The first column is read in as X array, the
second as Y1 array, the third as Y2 array, and so forth. The X-Y1
array is defined as SET 1, X-Y2 array is defined as SET 2, etc.
The first few lines of the file can contain text (a string
starting with a non-numeric character) . Each record (row) of
data should end with carriage return . The sample data file
ROCKWL.DAT is of Type 1.
Type 2 : This type of file can contain upto 15 SETS of X-Y pairs
of data, each set containing upto 15,000 pairs. Each set of data
is separated by non-numeric text. The file should contain only 2
columns of data. Each record (row) of data should be separated by
a carriage return. The sample file FATIG.DAT is of type 2.
6. SYMBOLS AND SYMBOL CODES
The SP contains 10 discrete plotting symbols and 10 type of
lines. A data set can also be plotted as histogram. By default,
symbols 11 thru 20 are assigned to the first 10 data sets, and 1
thru 5 to 11th thru 15th data set. User can reassign the symbols
in any order.
7. USER INSTRUCTIONS
The SP can be invoked at the DOS prompt as follows :
SP<CR>
when prompted, enter name of the data file to be plotted
The following display appears. This is the main plotting menu.
A : Min-Max values X-Minimum X-Maximum Y-Minimum Y-Maximum
10 0 12
B : Tic Intervals X-Major X-Minor Y-Major Y-Minor
2 1 2 1
E : X-Axis Label=`Distance from surface (in)'
E : Y-Axis Label=`Hardness (Rc)'
M : Mode (Linear/Log) : X-Axis...LIN Y-Axis...LIN
F : Physical plot size: X-Axis.. 3.5 - 25 Y-Axis.. 3.5-18.5 cms
G : Data Set # : 1 2 3 4 5 6
Symbols : 11 12 13 14 15 16
P : Pen Number: 1 1 1 1 1 1
S : Save plotting parameters in a file
L : Load plotting parameters from a file
X : Preview Z : Plot on a pen plotter D:Change character sizes
T : Transformations : X-axis None Y-axis None
O : OVERPLOT OPTION TOGGLE(OFF) H : Legend & Text
N : READ A NEW DATA FILE C : Curvefit Menu Q: QUIT
CURRENT FILE IS ..ROCKWL.DAT
Enter desired option to change format or to plot
When this menu appears, a plot can be viewed on the screen by
pressing X. Any of the settings listed on this menu can be
changed by pressing the corresponding letter that appears in
front of each setting or command. A description of each of the
options is given below :
A : Min-Max values : By default, the minimum and the maximum of
the data are used as plotting limits. When this option is
selected, the user will be prompted to enter the new limits for
plotting. Data that fall outside these limits will not be
plotted.
B: Tic Intervals : By default, there are five major tic-intervals
on each axis, and for every major tic-interval, there are five
minor tic intervals. To completely suppress the minor tic
intervals, enter the tic interval as zero. Do no enter zero for
the major tic interval.
E: Axes Labels : This option can be used to redefine X- and Y-
axis labels. Both upper and lower case characters can be used.
M: Plotting Mode : One of the following plotting mode can be
selected
1. linear on X, linear on Y (default)
2. linear on X, log on Y
3. log on X , linear on Y
4. log on X, log on Y
5. linear on X, Normal probability scale on Y
6. log on X, Normal probability scale on Y (Log Normal)
7. log on X, Weibull on Y (Weibull scale)
For log scales, the all the data should be >0. For Normal
probability and Weibull scales , the data should Be >0 and <1.
F : Physical plot size : This option is applicable only
applicable to HPGL pen plotters. By selecting this option, the
physical size of the plot is specified as lengths (in cms) of the
X- and Y-axis and the coordinated of the left-bottom corner of
the plot. The default values for lengths of X-and Y-axes are
21.5 cms and 15 cms, respectively. The left-bottom corner is 3.5
cms up and right to the edges of the paper.
G : Symbols : A set of ten discrete symbols and 10 types of lines
are provided. By selecting this option, the user can reassign
symbols to the data sets. To suppress plotting of a data set set,
select its symbol code as zero.
P : Pen Number : This option is applicable only to multi-pen
plotters. By selecting this option, different pens can be
assigned to the data sets.
S : Save Plotting Parametes : When this option is selected, the
user is prompted to enter a file name for saving the plotting
parameters. This parameter file can then be recalled later using
the L option.
L : Load Plotting Parameters : This option is used to recall the
plotting parameters saved in a file using the S option.
X : Preview : This option is used to preview the plot on the
screen.
Z : This option is used to send plot to the plotter or to save
the HPGL commands to a file.
D : Character Size : This option is used to change the size of
characters for writing tic labels, axes labels, legends and text.
The character sizes are applicable only to HPGL plotters.
(T) : Transformations : This option is used to tranform the X-
and/or Y-arrays by one of the following transformations :
ID Transformation
0. Znew = Zold
1. Znew = A + B * Zold
2. Z = A + B *Ln( Z )
new old
3. Znew = A + ( Zold) B
Z
4. Znew = A +( B) old
where Z refers to the X- or Y- arrays. Transformations are always
performed on the original data and for the purpose of plotting
only. The data file is not affected.
O : Overlay Option : This option is applicable only to the HPGL
plotters. When this option is on, frame, tic labels, and axes
labels are not plotted. By default, this option is turned off.
(N) New data file : This option is used to select another data
file for plotting. Only one file can be plotted at a time.
(C) Curvefit : When this option is selected, the Curvefit Menu
is displayed (see the CURVEFIT MENU)
(Q) Quit : This option is used to exit from the plotting program.
(H) Legend and Text : This option is used to enter the legends (
a short line of text describing each data set) and additional 5
lines of text. This option is used to write the legends and text
on the plot while previewing on the screen and then plotting to a
file. If the plotting is to be done directly to a plotter, the
user will be prompted to position the pen and enter the text ,
after all the data are plotted.
Curvefit Menu : This menu is displayed when option C is pressed
from the plotting menu
Equations available for curve fitting --
1. Y = A + B*X
2. Y = A + B*X + C*X^2
3. Y = A + B*X + C*X^2 + D*X^3
4. Y = A + B*X + C*X^2 + D*X^3 + E*X^4
5. Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5
6. Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5 + G*X^6
7. Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5 + G*X^6 + H*X^7
8. Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5 + G*X^6 + H*X^7 +
I*X^8
9. Spline-smoothen
Number of user-input data sets = 1
New Sets # 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Data Set # 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Equation # 0 0 0 0 0 0 0 0 0 0 0 0 0 0
New set # ( Enter 0 to Exit) ?
The number of curve fits that can be performed is 15-the number
of user defined data sets. For example to curve fit data set 1 to
equation 3, and to put the result in a new data set, define
New Set# as 2
Data Set# as 1
Equation # as 3
Any user defined data set can be curve fitted to as many
equations as desired, limited only by the available number of
data sets. Enter zero to exit from the menu. If the curve fit
option is selected, the user is next prompted to enter a filename
to save the results of the curve fits.
PREVIEW SUB-MENU :
When the Preview(x) option is selected form the plotting menu, a
plot of the data is displayed , and following options are
displayed at the bottom :
F1 : Fast F2 : Slow F5 : Done F10 : accept
A cursor is displayed on the graph. The cursor can be moved by
using the cursor keys on the numeric keypad. The X- and Y-
coordinated of the cursor location are displayed at the bottom of
the screen. The function keys F1 and F2 can be used to speed up
or slow down the cursor movement, respectively. If you are
planning to send the plot to a file, and if you have entered
legends and text using the H option from the plot options menu,
then the key F10 can be used to place the legends and text on the
plot. First position the cursor where you wish to place the
legends and then press the function key F10. The legends for all
the data set would be printed on the plot. Follow the same
procedure for upto five additional lines of text. Press the key
F5 to exit from the loop. Then press Y to return to the plot
options menu.
(Z) PLOT TO A PEN PLOTTER : This option is selected to to send
the plot to a pen plotter or to send the HPGL commands to a file.
8. HINTS FOR EFFICIENT USE OF SP
a. The following keystrokes will produce a plot on the screen and
on a HPGL plotter -
SP <cr> Start the program
<cr>
ROCKWL.DAT<cr> Enter the name of the data file
x Preview on the screen
F5 Done
Y Go back to the main menu
Z Plot on a HPGL plotter
<cr> No rotation
<cr> Plot appears on the plotter
b. The following keystrokes will produce a plot on the screen
and save the HPGL commands to a file -
SP <cr> Start the program
<cr>
ROCKWL.DAT<cr> Enter the name of the data file
x Preview on the screen
F5 Done
Y Go back to the main menu
Z Send plotter output to a file
<cr> No rotation
ROCKWL.HPL<cr> Plotter output will be saved in
this file
c. PRINTGL software , available on the CIME BBS can convert
these HPGL files to print on a variety of dot-matrix and laser
printers.
d. To use this program with a hercules card, load MSHERC.COM,
before running SP.
e. SENDHPGL program can be used to download a HPGL file (created
by this program or any other software) to a plotter. Run
SENDHPGL, and follow the instructions that appear on the monitor.
9. OTHER RELATED PROGRAMS :
If you find this program useful, you may also be interested in
acquiring the following programs, all of which are distributed as
shareware.
NP51 : Normal Probability & Histogram Plotting Program
CCHARTS : X-bar, r, c and p control charts program
Registration for each program is $25 and the source code can be
acquired for $195.